uncontrolled copy when printed or downloaded. please refer to the 4d systems website for the latest revision of this document arduino display module pack featuring 2.4 serial display module ulcd - 24 - ptu - ar document date: 23 rd january 2013 document revision: 1.1 d atasheet 4d systems turning technology into art
ulcd - 24 - ptu - ar C arduino display module pack contents 1. description ................................ ................................ ................................ ............................. 3 2. advanced hardware options ................................ ................................ ................................ .. 4 3. arduino serial library functions ................................ ................................ .............................. 5 4. specifications and ratings ................................ ................................ ................................ ....... 8 5. legal notice ................................ ................................ ................................ ............................ 9 6. contact information ................................ ................................ ................................ ............... 9
4d systems ulcd - 24 - ptu - ar ? 2012 4d systems page 3 of 9 www.4dsystems.com.au ulcd - 24 - ptu - ar C arduino display module pack 1. d escription the 4d systems arduino display module pack (ulcd - 24 - ptu - ar) is made up of a ulcd - 24 - ptu display module specifically customised for the arduino. the pack comprises of: ? customised ulcd - 24 - ptu display module ? 4d arduino adaptor shield ? 5 way female - female cable the arduino display module pack enables an arduino user to quickly connect the 4d arduino adaptor shield to their arduino, connect the 5 way cable between the adaptor and the display module, and b e connected in seconds to start programming their new 4d systems display. the ulcd - 24 - ptu - ar has a comprehensive range of serial commands ready to be received from the arduino, to draw primitives such as lines, rectangles, circles and text, to displaying images, playing sound and logging data to usd card. communication to the display module is performed via the a rduino s serial port (rx and tx) . a single digital on the arduino (d2) is utilised for an external reset for the display. power for the display is supplied from the arduinos 5v bus. no external power is required for the display module as all power is supplied from the arduino , via the adaptor shield. for a detailed listing of the serial commands available, please refer to the appendix section of this document. 4d arduino adaptor shield the ulcd - 24 - ptu display module arduino display module pack connected together (note: arduino not included in pack )
4d systems ulcd - 24 - ptu - ar ? 2012 4d systems page 4 of 9 www.4dsystems.com.au ulcd - 24 - ptu - ar C arduino display module pack 2. advanced hardware options the display module (ulcd - 24 - ptu) is a very capable and powerful piece of hardware, which can be reconfigured beyond the boundaries of the arduino. with the use of the 4d systems workshop4 ide software, the display module can be configured and programmed independently of the arduino environement. if a user wishes to investigate the capabilities of the ulcd - 24 - ptu and reconfigure the display module, p lease refer to the datasheet for the ulcd - 24 - ptu, available from the 4d systems website, www.4dsystems.com.au . the user can freely change back to the configuration the module was shipped in if desired, all via th e workshop4 ide software. to take advantage of the 4d systems workshop4 software, a 4d programming cable is required, which can be purchased from the 4d systems website, or from a 4d systems distributor.
4d systems ulcd - 24 - ptu - ar ? 2012 4d systems page 5 of 9 www.4dsystems.com.au ulcd - 24 - ptu - ar C arduino display module pack 3. arduino serial library functions the following is a list of arduino functions available to use with the 4d systems arduino serial library. for detailed information on each of these functions, please refer to the arduino library itself available from the samples menu of the 4d systems workshop 4 software or from the 4d systems github repository. please also refer to the product page and to the application notes , available from the 4d systems website, www.4dsystems.com.au graphics functions: ? gfx_cls() ? gfx_changecolour(oldcolour, newcolour) ? gfx_circle(x, y, radius, colour) ? gfx_circlefilled(x, y, radius, colour) ? gfx_line(x1, y1, x2, y2, colour) ? gfx_rectangle(x1, y1, x2, y2, colour) ? gfx_rectanglefilled(x1, y1, x2, y2, colour) ? gfx_polyline(n, vx, vy, colour) ? gfx_polygon(n, vx, vy, colour) ? gfx_triangle(x1, y1, x2, y2, x3, y3, colour) ? gfx_orbit(angle, distance) ? gfx_putpixel(x, y, colour) ? gfx_getpixel(x, y) ? gfx_moveto(xpos, ypos) ? gfx_lineto(xpos, ypos) ? gfx_setclipregion() ? gfx_ellipse(x, y, xrad, yrad, colour) ? gfx_ellipsefilled(x, y, xrad, yrad, colour) ? gfx_button(state, x, y, buttoncolour, textcolour, font, textwidth, textheight, text) ? gfx_panel(state, x, y, width, height, colour) ? gfx_slider(mode, x1, y1, x2, y2, colour, scale, value) ? gfx_screencopypaste(xs, ys, xd, yd, width, height) ? gfx_trianglefilled(x1, y1, x2, y2, x3, y3, colr) ? gfx_polygonfilled(n, vx, vy, colr) ? gfx_get(mode) ? gfx_clipwindow(x1, y1, x2, y2) ? gfx_set(function, value) gfx_set shortcuts: ? gfx_bgcolour(colour) ? gfx_clipping(mode) ? gfx_transparentcolour(colour) ? gfx_transparency(mode) ? gfx_framedelay(delay) ? gfx_screenmode(delay) ? gfx_outlinecolour(colour) ? gfx_contrast(value) ? gfx_linepattern(pattern) ? gfx_bevelwidth(m ode) ? gfx_bevelshadow(value) touch screen functions: ? touch_detectregion(x1, y1, x2, y2) ? touch_set(mode) ? touch_get(mode)
4d systems ulcd - 24 - ptu - ar ? 2012 4d systems page 6 of 9 www.4dsystems.com.au ulcd - 24 - ptu - ar C arduino display module pack text and string functions: ? charwidth('char') ? charheight('char') ? putstr(pointer) ? txt_set(function, value) txt_set shortcuts: ? txt_fgcolour(colour) ? txt_bgcolour(colour) ? txt_fontid(id) ? txt_width(multiplier) ? txt_height(multiplier) ? txt_xgap(pixelcount) ? txt_ygap(pixelcount) ? txt_opacity(mode) ? txt_bold(mode) ? txt_italic(mode) ? txt_inverse(mode) ? txt_underlined(mode) ? txt_attributes(value) ? txt_wrap(value) image control functions: ? img_setposition(handle, index, xpos, ypos) ? img_enable(handle, index) ? img_disable(handle, index) ? img_darken(handle, index) ? img_lighten(handle, index) ? img_setword(handle, index, offset, word) ? img_getword(handle, index, offset) ? img_show(handle, index) ? img_setattributes(handle, index, value) ? img_clearattributes(handle, index, value) ? img_touched(handle, index) media functions (sd/sdhc memory card): ? media_init() ? media_setadd(hiword, loword) ? media_setsector(hiword, loword) ? media_rdsector(destination_address) ? media_wrsector(source_address) ? media_readbyte() ? media_readword() ? media_writebyte(byte_val) ? media_writeword(word_val) ? media_flush() ? media_image(x, y) ? media_video(x, y) ? media_videoframe(x, y, framenumber) serial ( uart) communications functions: ? setbaud(rate)
4d systems ulcd - 24 - ptu - ar ? 2012 4d systems page 7 of 9 www.4dsystems.com.au ulcd - 24 - ptu - ar C arduino display module pack fat16 file functions: ? file_error() ? file_count(filename) ? file_dir(filename) ? file_findfirst(fname) ? file_findnext() ? file_exists(fname) ? file_open(fname, mode) ? file_close(handle) ? file_read(destination, size, handle) ? file_seek(handle, hiword, loword) ? file_index(handle, hisize, losize, recordnum) ? file_tell(handle, &hiword, & loword) ? file_write(source, size, handle) ? file_size(handle, &hiword, & loword) ? file_image(x, y, handle) ? file_screencapture(x, y, width, height, handle) ? file_putc(char, handle) ? file_getc(handle) ? file_putw(word, handle) ? file_getw(handle) ? file_puts(source, handle) ? file_gets(*string, size, handle) ? file_erase(fname) ? file_rewind(handle) ? file_loadfunction(fname.4xe) ? file_run(fname..4xe, arglistptr) ? file_exec(fname..4xe, arglistptr) ? file_loadimagecontrol(fname1, fname2, mode) ? file_mount() ? file_unmount() ? file_playwav sound control functions: ? snd_volume(var) ? snd_pitch(pitch) ? snd_bufsize(var) ? snd_stop() ? snd_pause() ? snd_continue() ? snd_playin g() timer functions: ? sys_sleep(units)
4d systems ulcd - 24 - ptu - ar ? 2012 4d systems page 8 of 9 www.4dsystems.com.au ulcd - 24 - ptu - ar C arduino display module pack 4. specifications and ratings recommended operating conditions parameter conditions min typ max units supply voltage (vcc) 4.5 -- 5.5 v operating temperature - 10 -- +70 c ordering information order code: ulcd - 24 - ptu - ar package: 138mm x 100mm x 30mm packaging: module sealed in antistatic foam padded 4d systems box
4d systems ulcd - 24 - ptu - ar ? 2012 4d systems page 9 of 9 www.4dsystems.com.au ulcd - 24 - ptu - ar C arduino display module pack 5. legal notice proprietary information the information contained in this document is the property of 4d systems pty. ltd. and may be the subject of patents pending or granted, and must not be copied or disclosed without prior written permission. 4d systems endeavours to ensure that the informa tion in this document is correct and fairly stated but does not accept liability for any error or omission. the development of 4d systems products and services is continuous and published information may not be up to date. it is important to check the curr ent position with 4d systems. 4d systems reserves the right to modify, update or makes changes to specifications or written material without prior notice at any time. all trademarks belong to their respective owners and are recognised and acknowledged. disclaimer of warranties & limitation of liability 4d systems makes no warranty, either expressed or implied with respect to any product, and specifically disclaims all other warranties, including, without limitation, warranties for merchantability, non - in fringement and fitness for any particular purpose. information contained in this publication regarding device applications and the like is provided only for your convenience and may be superseded by updates. it is your responsibility to ensure that your ap plication meets with your specifications. in no event shall 4d systems be liable to the buyer or to any third party for any indirect, incidental, special, consequential, punitive or exemplary damages (including without limitation lost profits, lost savings , or loss of business opportunity) arising out of or relating to any product or service provided or to be provided by 4d systems, or the use or inability to use the same, even if 4d systems has been advised of the possibility of such damages. 4d systems pr oducts are not fault tolerant nor designed, manufactured or intended for use or resale as on line control equipment in hazardous environments requiring fail C safe performance, such as in the operation of nuclear facilities, aircraft navigation or communic ation systems, air traffic control, direct life support machines or weapons systems in which the failure of the product could lead directly to death, personal injury or severe physical or environmental damage (high risk activities). 4d systems and it s suppliers specifically disclaim any expressed or implied warranty of fitness for high risk activities. use of 4d systems products and devices in 'high risk activities' and in any other application is entirely at the buyers risk, and the buyer agrees to defend, indemnify and hold harmless 4d systems from any and all damages, claims, suits, or expenses resulting from such use. no licenses are conveyed, implicitly or otherwise, under any 4d systems intellectual property rights. 6. contact information for technical support: support@4dsystems.com.au for sales support: sales@4dsystems.com.au website: www.4dsystems.com. au copyright 4d systems pty. ltd. 2000 - 2012.
mouser electronics authorized distributor click to view pricing, inventory, delivery & lifecycle information: 4d systems: ? ulcd-24ptu-ar
|
